home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / pcbd120u.arc / PCBDRAW.DOC < prev    next >
Text File  |  1990-09-09  |  20KB  |  593 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                        PCBDraw
  27.  
  28.  
  29.                                         v1.20
  30.  
  31.  
  32.  
  33.                                   Copyright(c) 1990
  34.  
  35.                                       Jim Dailey
  36.  
  37.                                  All Rights Reserved
  38.  
  39.  
  40.                                   September 9, 1990
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                 Table of Contents
  74.  
  75.      WARRANTY  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  76.  
  77.      LEGAL STUFF . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  78.  
  79.      REGISTRATION and DISTRIBUTION . . . . . . . . . . . . . . . . . .    1
  80.  
  81.      USING PCBDRAW . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  82.  
  83.      COMMANDS  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    3
  84.           ALT-A  CHANGE TEXT COLOR . . . . . . . . . . . . . . . . . .    3
  85.           ALT-B BLOCK ACTION COMMANDS  . . . . . . . . . . . . . . . .    3
  86.                B - Box Draw  . . . . . . . . . . . . . . . . . . . . .    3
  87.                C - Copy Block  . . . . . . . . . . . . . . . . . . . .    3
  88.                D - Delete Block  . . . . . . . . . . . . . . . . . . .    3
  89.                F - Fill Block  . . . . . . . . . . . . . . . . . . . .    3
  90.                I - Insert Line . . . . . . . . . . . . . . . . . . . .    3
  91.                M - Move Block  . . . . . . . . . . . . . . . . . . . .    4
  92. |              P - Paint . . . . . . . . . . . . . . . . . . . . . . .    4
  93.                S - Save Block  . . . . . . . . . . . . . . . . . . . .    4
  94. |              T - Block Text  . . . . . . . . . . . . . . . . . . . .    4
  95.                X - Cut to Clipboard  . . . . . . . . . . . . . . . . .    4
  96.                Y - Delete Line . . . . . . . . . . . . . . . . . . . .    4
  97.           ALT-C  CLEAR SCREEN  . . . . . . . . . . . . . . . . . . . .    4
  98.           ALT-D SET DEFAULT CLEAR SCREEN COLOR . . . . . . . . . . . .    4
  99.           ALT-H  HELP  . . . . . . . . . . . . . . . . . . . . . . . .    4
  100.           ALT-I INSERT LINE  . . . . . . . . . . . . . . . . . . . . .    4
  101.           ALT-L  LOAD FILE . . . . . . . . . . . . . . . . . . . . . .    5
  102.           ALT-O CHANGE DRIVE/DIRECTORY . . . . . . . . . . . . . . . .    5
  103.           ALT-P PASTE  . . . . . . . . . . . . . . . . . . . . . . . .    5
  104.           ALT-S  SAVE FILE . . . . . . . . . . . . . . . . . . . . . .    5
  105. |         ALT-T Run DOS Command  . . . . . . . . . . . . . . . . . . .    5
  106.           ALT-U  USE COLOR UNDER CURSOR  . . . . . . . . . . . . . . .    5
  107. |         ALT-W Insert PC Board Macro  . . . . . . . . . . . . . . . .    5
  108.           ALT-X  EXIT PCBDraw  . . . . . . . . . . . . . . . . . . . .    5
  109.           ALT-Y  DELETE LINE . . . . . . . . . . . . . . . . . . . . .    5
  110.           ALT-Z SHELL to DOS . . . . . . . . . . . . . . . . . . . . .    6
  111.           CTRL-END  DELETE TO END OF LINE  . . . . . . . . . . . . . .    6
  112.           PGUP  CURSOR AT TOP OF SCREEN  . . . . . . . . . . . . . . .    6
  113.           PGDN  CURSOR AT BOTTOM OF SCREEN . . . . . . . . . . . . . .    6
  114.           HOME  BEGINNING OF LINE  . . . . . . . . . . . . . . . . . .    6
  115.           END  END OF LINE . . . . . . . . . . . . . . . . . . . . . .    6
  116.  
  117. |    ACKNOWLEDGEMENTS  . . . . . . . . . . . . . . . . . . . . . . . .    6
  118.  
  119.      COMMENTS SUGGESTIONS and BUG REPORTS  . . . . . . . . . . . . . .    6
  120.  
  121.  
  122.  
  123.           PCBDraw v1.20
  124.                                                                           i
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.      INTRODUCTION
  139.  
  140.           With the release of PC Board 14.5 I saw a need for a clone of
  141.           TheDraw to create, save, and update screens using the new @X
  142.           color codes.  It was a hassle for me to use TheDraw then use
  143.           Convert to change them.  Hence, came the birth of PCBDraw. 
  144.           PCBDraw does not now, nor will it ever, support ANSI control
  145.           sequences.  If and when the time comes that PC Board supports
  146.           cursor positioning, I will consider incorporating the same in
  147.           PCBDraw.
  148.  
  149.  
  150.      WARRANTY
  151.  
  152.           PCBDraw is provided "as is" without warranty of any kind, either
  153.           expressed or implied. The only guarantee that I will make is that
  154.           it will occupy disk space and that it works on my system. If you
  155.           decide to use PCBDraw, you do so at your own risk.  In no event
  156.           will the author, James B. Dailey, or SysOps posting PCBDraw, be
  157.           liable to you for any damages, including but not limited to, any
  158.           lost profits, lost savings, or other incidental or consequential
  159.           damages arising out of the use or inability of PCBDraw.
  160.  
  161.  
  162.      LEGAL STUFF
  163.  
  164.           PCBDraw is the Copyrighted property of James B. Dailey.  You are
  165.           not authorized to modify, merge, reverse assemble or reverse
  166.           compile the program, it's documentation, or the distribution ZIP
  167.           file.  You may terminate this agreement by destroying all copies
  168.           of PCBDraw and it's documentation, and distribution ZIP file. 
  169.           James B. Dailey may terminate your license if you fail to comply
  170.           with the terms and conditions of this agreement.
  171.  
  172. |         PC Board is a Trademark and Copyrighted works of Clark
  173. |         Development Company, Orem Utah.
  174.  
  175.  
  176.      REGISTRATION and DISTRIBUTION
  177.  
  178.           PCBDraw is distributed as shareware/freeware.  In other words I
  179.           do not require a registration fee for it's use in a NON
  180.           COMMERCIAL environment.  However, a registration fee of $20 will
  181.           be accepted if you feel PCBDraw is of benefit to you.  Your
  182.           registration of PCBDraw will get you my deepest gratitude, and
  183.           priority in the implementation of suggestions and enhancements. 
  184.           I will feel that my efforts are worthwhile.
  185.  
  186.           Commercial users are required to pay a mandatory $100 usage fee. 
  187.           PCBDraw was written primarily for the hobbyist PC Board SysOp. 
  188.  
  189.           PCBDraw v1.20
  190.                                                                           1
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.           Because of this I do net feel that any commercial interests
  204.           should not make a profit from my work.  If you run a BBS
  205.           supported by your business, charge a fee for callers to download
  206.           from your BBS, or run a so called "software distribution"
  207.           business charging a fee for the disks, then you are commercial
  208.           interest and you owe me $100.
  209.  
  210.           PCBDraw may be posted for general downloading on your BBS as long
  211.           as you do not charge your callers a fee for downloading. 
  212.  
  213.           Registration fees are to be sent in US dollars to:
  214.  
  215.                               James Dailey
  216.                               2136 Greenwick Rd.
  217.                               El Cajon, CA 92019
  218.  
  219. |         Registered users will have access to a special conference,
  220. |         (conference 39, on my BBS so they may download the most current
  221. |         release of PCBDraw and the current beta release if one exists.
  222. |         Registered users who are members of Fido Net will be allowed to
  223. |         File Request the last versions of PCBDraw.
  224.  
  225.  
  226.      USING PCBDRAW
  227.  
  228.           If you have ever used TheDraw, then you will find PCBDraw just as
  229.           easy to use. The function keys are used for special character,
  230.           especially those used for making boxes.  PCBDraw, by using PC
  231.           Board 14.5 @X color codes, allows you to create colorful screen
  232.           images without the use of ANSI control sequences.  Using the @X
  233.           color codes, frees up disk space as only one copy of a screen
  234.           image needs to be maintained.  
  235.  
  236.           The editing screen is currently limited to 80 characters per
  237.           line, 24 lines per screen.  Sometime in the future, I will be
  238.           adding the ability to maintain several pages per file. This will
  239.           be advantageous for high lighting text files such as help files
  240.           and special instructions.
  241.  
  242. |         PCBDraw will accept, as command line input, the name of a file it
  243. |         will automatically load after the logo screen is displayed.  This
  244. |         will allow PCBDraw to be used as your ANSI color editor in PCB
  245. |         Setup.
  246.  
  247.           Though not as robust as TheDraw, PCBDraw gives you the necessary
  248.           editing functions necessary for creating, saving, and changing
  249.           your screen images.  I will be adding more functionality to
  250.           PCBDraw to make it a more complete screen manager.  The functions
  251.           to be added will depend on what you the user wishes to see and
  252.           what I feel are required.  Registered users of PCBDraw will have
  253.           their suggestions given top priority.
  254.  
  255.           PCBDraw v1.20
  256.                                                                           2
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.      COMMANDS
  271.  
  272.           ALT-A  CHANGE TEXT COLOR
  273.           When pressed, a screen is displayed allowing you to change the
  274.           default character attribute.  The F1, F2, Left Arrow, and Right
  275.           arrow changes the foreground color. The F3, F4, Up Arrow, and
  276.           Down Arrow keys change the background color.  The F5 key toggles
  277.           blink and the F6 key toggles bold.
  278.  
  279.           ALT-B BLOCK ACTION COMMANDS
  280.           This command, allows the user to mark a block of the screen and
  281.           perform various functions or operations to the marked block.  The
  282.           operations permitted on marked blocks are:
  283.  
  284.                B - Box Draw
  285.                This sub command will draw a box around the marked area. 
  286.                The characters used for drawing the box will be taken from
  287.                the active character set.  If the active character set does
  288.                not contain box draw characters then a box with out borders
  289.                will be drawn.
  290.  
  291.                C - Copy Block
  292.                This sub command will copy the marked block to another
  293.                location on the screen.  The original text is left intact
  294.                and not disturbed.  Use the arrow keys for moving the block
  295.                around the screen.
  296.  
  297.                D - Delete Block
  298.                This sub command will delete the marked block.  The marked
  299.                area will be filled with blanks with the background color
  300.                the same as the clear screen color.
  301.  
  302.                F - Fill Block
  303.                This command will fill a block with a specific character. 
  304.                You may enter the single character with it's appropriate key
  305.                or use a function key to use a character from the current
  306.                character set.
  307.  
  308.                I - Insert Line
  309.                This command will insert a blank line before the top line of
  310.                a marked block.  This is convenient when you have a screen
  311.                image divided into separate areas like a command menu.  If
  312.                you want to add a line to a specific area and not the entire
  313.                screen just block off the area and enter "I".
  314.  
  315.                M - Move Block
  316.                This command will move a block to another location of the
  317.                screen.  The space occupied by the block will be filled with
  318.                spaces with the background color set to that of the current
  319.                clear screen color.
  320.  
  321.           PCBDraw v1.20
  322.                                                                           3
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335. |              P - Paint
  336. |              This sub command will "Paint" the marked block with a new
  337. |              foreground and background color.
  338.  
  339.                S - Save Block
  340.                This will save the marked block to a file.  When the file is
  341.                re-loaded, the marked block will load beginning with row 1
  342.                column 1.
  343.  
  344. |              T - Block Text
  345. |              This will draw a box around the marked area without
  346. |              destroying the text inside the box.  The character selection
  347. |              for the box frame follows the same rules as the regular box
  348. |              draw command.
  349.  
  350.                X - Cut to Clipboard
  351.                This command will copy the marked block to a clip board
  352.                buffer.  The block can then be pasted with the paste (ALT-P)
  353.                command.  The contents of the clipboard buffer will remain
  354.                intact until another block is cut.  This will allow you to
  355.                copy a portion of a screen image, load another image, and
  356.                paste the cut block to the new screen image.
  357.  
  358.                Y - Delete Line
  359.                This command delete the top line of a marked block.
  360.                 
  361.           ALT-C  CLEAR SCREEN
  362.           When pressed will clear the current screen.  The background will
  363.           be set to the default clear screen color.
  364.  
  365.           ALT-D SET DEFAULT CLEAR SCREEN COLOR
  366.           When pressed, a screen much like the one displayed with ALT-A is
  367.           displayed.  The F3, F4, Up Arrow, and Down Arrow are used for
  368.           selecting the background color.  Whenever the current screen is
  369.           cleared it will be cleared to this color.  When a line is
  370.           inserted or a character deleted from a line this empty space is
  371.           filled with this color.
  372.  
  373.           ALT-H  HELP
  374.           When pressed, will display a quick reference of all the PCBDraw
  375.           commands.
  376.  
  377.           ALT-I INSERT LINE
  378.           When pressed, will insert a blank line.  The line will take the
  379.           color of the default clear screen color.
  380.  
  381.           ALT-L  LOAD FILE
  382.           This command will load a previously saved file.  When pressed a
  383.           menu will be displayed of all the files in the current directory. 
  384.           Pressing enter will load the highlighted file.  Use the Arrow
  385.           keys, Page Up or Page Down keys to high light your file
  386.  
  387.           PCBDraw v1.20
  388.                                                                           4
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.           selection.  You may also enter a file name instead of using the
  402.           menu.
  403.  
  404.           ALT-O CHANGE DRIVE/DIRECTORY
  405.           This command allows you to change the default directory where
  406.           PCBDraw loads and saves it's files.  When PCBDraw is terminated,
  407.           you will always be placed in the directory from which it was
  408.           started.
  409.  
  410.           ALT-P PASTE
  411.           This command will paste a block that has been cut to the
  412.           clipboard by the "X" sub-command of the block action commands.  
  413.  
  414.           ALT-S  SAVE FILE
  415.           This command allows you to save your finely crafted work of art. 
  416.           If the file name you enter exists, you will be prompted for
  417.           permission to overwrite the file.
  418.  
  419. |         ALT-T Run DOS Command
  420. |         This command is used to run a DOS command from PCBDraw without
  421. |         having to shell to shell out to DOS.  This command can be a quick
  422. |         way to convert single screen ANSI files to PC Board.  To convert
  423. |         your WELCOMEG screen first enter "ALT-T".  At the save screen
  424. |         prompt enter "N" for know.  When prompted for the DOS command
  425. |         enter "TYPE C:\PCB\GEN\WELCOMEG" (assuming PC Board is on drive
  426. |         C).  When the TYPE command finishes, you will have your WELCOMEG
  427. |         file converted and all you need to do is save it.
  428.  
  429.           ALT-U  USE COLOR UNDER CURSOR
  430.           This command will set the default attribute to that at the
  431.           current cursor location.
  432.  
  433. |         ALT-W Insert PC Board Macro
  434. |         This command will display a list of each of the PC Board macros
  435. |         and a short description.  To insert a macro, simply cursor to the
  436. |         macro you wish to use and press enter.  Note: this feature is
  437. |         available in registered versions of PCBDraw only.
  438.  
  439.           ALT-X  EXIT PCBDraw
  440.           Exits PCBDraw and returns you to the DOS prompt.
  441.  
  442.           ALT-Y  DELETE LINE
  443.           Deletes the line the cursor is on.  Line 24 of the screen will be
  444.           set to blanks with the back ground to that of the default clear
  445.           screen color.
  446.  
  447.           ALT-Z SHELL to DOS
  448.           This command allows you to shell to DOS.  When you are finished
  449.           whatever DOS processing you require type "EXIT" to return to
  450.           PCBDraw
  451.  
  452.  
  453.           PCBDraw v1.20
  454.                                                                           5
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.           CTRL-END  DELETE TO END OF LINE
  468.           Deletes all characters on the current line from the cursor to the
  469.           end of line.
  470.  
  471.           PGUP  CURSOR AT TOP OF SCREEN
  472.           Places the cursor at row 1 column 1
  473.  
  474.           PGDN  CURSOR AT BOTTOM OF SCREEN
  475.           Places the cursor at row 24 column 1
  476.  
  477.           HOME  BEGINNING OF LINE
  478.           Places the cursor at column 1 of the current line.
  479.  
  480.           END  END OF LINE
  481.           Places the cursor at column 80 of the current line. 
  482.  
  483.  
  484. |    ACKNOWLEDGEMENTS
  485.  
  486. |         I would like to thank Michael Nelson of Sea Hunt BBS for his help
  487. |         in testing PCBDraw and helping making it DesqView aware.
  488.  
  489. |         I would like to thank Clark Development for providing the best
  490. |         BBS software on the market today.
  491.       
  492.  
  493.      COMMENTS SUGGESTIONS and BUG REPORTS
  494.  
  495.           Your comments and suggestions are important to me and I am
  496.           interested in hearing from you.  If you are a registered user of
  497.           PCBDraw, you enhancement suggestions will be given top priority. 
  498.           I will not guarantee that I will implement your suggestion but,
  499.           if your idea is implemented, it will be done before a non-
  500.           registered users suggestion.  
  501.  
  502.           Bug reports will always be given the highest priority, even above
  503.           enhancement suggestions.  I believe that a program should have
  504.           it's documented features working error free.  If you discover any
  505.           problems or bugs I want to hear about them.  If you discover a
  506.           bug, please explain the problem clearly.  If possible, please
  507.           send me a copy of the screen image causing the problems.
  508.  
  509.           There are 4 ways in which to report problems or suggestions:
  510.  
  511.                1. You may call my BBS, DOOGER'S Place at (619) 588-8931. 
  512.                All first time callers are allowed to leave comments.
  513.  
  514.                2. Send me net mail at my Fido Net address of 1:202/309.
  515.  
  516.                3. Leave a message in the Fido Net PCBoard echo conference.
  517.  
  518.  
  519.           PCBDraw v1.20
  520.                                                                           6
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                4. As long as Clark Development has no objections, you may
  534.                leave a message in the support conference.
  535.  
  536.  
  537. |         The latest version of PCBDraw can always be file requested with
  538. |         the magic file name of PCBDRAW.  If you are a registered use, and
  539. |         supply your file request password you will automatically receive
  540. |         the registered version.  All other requests, incorrect or missing
  541. |         passwords will cause the unregistered version to be sent.
  542.  
  543.           Good Luck and thank you for using PCBDraw.
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.           PCBDraw v1.20
  586.                                                                           7
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.